home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / e-tools / plugins / plugin_textimagebutton / plugin_textimagebutton.doc next >
Encoding:
Text File  |  1996-04-11  |  4.5 KB  |  115 lines
  1. Quick Reference "Plugin_TextImageButton.m"  © 1996 by Sebastian Hesselbarth
  2.  
  3.  
  4. +--------- --- -- - -  Introduction
  5.  
  6. This Archive contains a PLUGIN written for the AmigaE-GUI-Designer
  7. called EasyGUI ! It has been compiled with AmigaE-version 3.2e and I think
  8. you need at least this version (> 3.2a) to use this module !
  9. So if you don't have this version contact your national E distibutor to
  10. buy/upgrade you AmigaE compiler. (Greetings to Joerg Wach ;) )
  11.  
  12. Right... I wrote this module to make it possible for EasyGUI programmers to
  13. use images and buttons with images in their EasyGUIs.
  14. I think Wouter wants to include this kind of buttons in EasyGUI, so feel free
  15. to contact me Wouter :)
  16.  
  17. +--------- --- -- - -  Legal stuff
  18.  
  19. The programs and modules in this archive are
  20. Copyright © 1996 by Sebastian Hesselbarth.
  21.  
  22. Further the Plugin_TextImageButton module and the source are dedicated to
  23.   the author of the AmigaE language Wouter van Oortmerssen ...
  24.  
  25. You are free to include the module in your programs, whether free-/pubilc-
  26. share-/"whatever"-ware or commercial. 
  27. The only thing that's a must is that the archive must be complete and must
  28. contain all files unmodified if you want to redistibute it.
  29. TO ALL PD-DISK-SELLERS WHICH TAKE MORE THAN 3DM FOR ONE DISK :
  30.  "F**K YOU AND THANK GOD THAT YOUR CUSTOMERS DON'T KNOW THE WORLD OF AMINET !"
  31.  
  32. I make no guaranties that this module is totally bug-free or work as expected.
  33. This module is not really betatested so if you find any bug/error : contact me!
  34.  
  35. Finally I must say that it is your _own_ risk if you use this module and your
  36. AMIGA® travels in to the deepest abysses of the Himalaya. (Greets 2 the GURU ;)
  37. Or you harddisk reaches the NIRVANA while you use my program.
  38. In this case I can only say : "sorry pals!". ;)
  39.  
  40. +--------- --- -- - -  Requirements
  41.  
  42. * You need at least OS 2.0 (Upgrade pals !)
  43. * For programing you need AmigaE v3.2a+
  44. * Some ESources with images in it ! I'm glad to tell you that I can do this
  45.   for YOU ! Simple send me a disk (no emails yet :.(( ) with images in IFF
  46.   format and I'll convert 'em. Don't forget to put backstamps in the cuvert!
  47.   I hope the answer will be as quick as possible !
  48.  
  49. +--------- --- -- - -  Usage
  50.  
  51. This module uses the standard PLUGIN routines (are there any other ? ;)
  52. so you only ... have to look up in my example source or any other 
  53. source that uses plugins ...
  54.  
  55. The easiest way is this :
  56.  
  57. DEF tib : PTR TO textimagebutton_plugin
  58.  
  59. easygui('Title',
  60.   ...
  61.   [PLUGIN, 1, NEW tib.init (image,secondimage,tags)
  62.   ...
  63.   
  64. Where "tib" is a pointer to "textimagebutton_plugin" :)
  65. You must start "tib" with the "init" procedure ... the arguments are :
  66.  
  67. image           = A pointer to a memory area that contains an "image" structure
  68. secondimage     = ^^^ or NIL if you don't want a secondimage
  69. tags            = standard tagslist (TAGS below)
  70.  
  71. EPTIB_BORDER            = TRUE if you want to use an xtra border around your
  72.   image , FALSE if not. Default is TRUE, automatically set if EPTIB_TEXT 
  73.   is <> NIL.
  74.  
  75. EPTIB_TEXT              = if you want to have a text in your button you have
  76.   to enter a text after this TAG.
  77.  
  78. EPTIB_FONT              = wants a PTR to a "textattr" structure 
  79.   for example : ['topaz.font',8,0,0]:textattr.
  80.   If not set the button will use screen font.
  81.  
  82. EPTIB_IMGPOS            = Defines the position of the image ...
  83.   EPTIB_IPOSRIGHT       =   use this to put the image right of your text
  84.   EPTIB_IPOSLEFT        =   ^^                        left  ^^
  85.   EPTIB_IPOSTOP         =   ^^                        above ^^    
  86.   EPTIB_IPOSBOTTOM      =   ^^                        under ^^
  87. EPTIB_BGNORMAL          = defines the background of the button in normal state
  88. EPTIB_BGSELECTED        = ^^                                     pressed state
  89. EPTIB_RESIZE            = EPTIB_RESIZENONE, EPTIB_RESIZEX, EPTIB_RESIZEY ...
  90.   use them to define whether and how your button should resize, use
  91.   ..NONE for fixed size, ..RESIZEX for x only and ..RESIZEY for y only
  92.   stretching. combined x and y resizing : ..RESIZEY OR ..RESIZEY
  93.   (.. means EPTIB_RESIZE..)
  94.  
  95.  
  96. It's so simple isn't it ? Anyway you have problems with it contact me ...
  97.  
  98. The best thing is to look up in my example sources !!
  99.  
  100. +--------- --- -- - -  The Author
  101.  
  102. I'm still in school so don't blame me for grammatical errors ! ;)
  103.  
  104. Sebastian Hesselbarth
  105. Multhoepen 13
  106. 31855 Aerzen
  107. GERMANY
  108.  
  109. Tel. 05154 / 8051
  110. (international : ++49-(0)515-480-51)
  111.  
  112. Contact me for suggestions, bugs or just to start a project with me :)
  113. Sorry, no email yet .. but I hope it will come soon...
  114.  
  115. bye and happy programmin' !!